home *** CD-ROM | disk | FTP | other *** search
/ TeX 1995 July / TeX CD-ROM July 1995 (Disc 1)(Walnut Creek)(1995).ISO / macros / latex209 / contrib / latexinfo / README < prev    next >
Text File  |  1992-02-26  |  2KB  |  42 lines
  1. This is version 1.7 of the LaTeXinfo program, and is for Version 18
  2. of GNU Emacs.
  3.  
  4. Documentation for GNU utilities and libraries is usually written in a
  5. format called "TeXinfo".  This document describes an enhancement
  6. of this format which can be used with LaTeX instead of TeX.
  7.  
  8. LaTeXinfo offers a number of advantages over TeXinfo:
  9.  
  10.   1. The point size or layout style of a document can be changed easily,
  11.      using the `documentstyle' (article, report, book, twoside, ...).
  12.      
  13.   2. LaTeX has better error checking than TeX files, especially in
  14.      begin/end environments.  In addition, the LaTeX error messages are more
  15.      informative.  This makes it considerably easier to make extensions and
  16.      enhancements (read hacks).
  17.      
  18.   3. LaTeX delimits its arguments with braces, so it's easier to tell where
  19.      a LaTeXinfo command starts, and where it ends.  TeXinfo has to stand on
  20.      its head to avoid using TeX's braces.
  21.      
  22.   4. Any LaTeX commands not understood by the on-line manual generator
  23.      (`latexinfo.el') are simply ignored.  This means that you are free to add
  24.      a considerable number of LaTeX commands to make you manual look pretty,
  25.      as long as you don't care that there will be no action taken by the 
  26.      Info formatting program.
  27.      
  28.   5. It is easy to add your own extensions to the on-line manual generator
  29.      by making GNU Emacs handlers for your LaTeX extensions.  This is
  30.      the Emacs counterpart to the `documentstyle' options.  LaTeXinfo looks
  31.      in a specified directory for GNU Elisp code that corresponds to each
  32.      style file.  This makes it easy to modularize your style files.
  33.      
  34.   6. LaTeX has many advantages over TeX, such as being able to easily
  35.      incorporate the BibTeX bibliography formatting program.
  36.  
  37. See the file INSTALL for installing LaTeXinfo.     
  38.  
  39. Please report any errors or suggestions to mike@apl.ists.ca
  40.  
  41. Mike Clarkson
  42.